gtk_application_new(): Docs: application_id may now be null.

https://bugzilla.gnome.org/show_bug.cgi?id=671249

diff --git a/gtk/gtkapplication.c b/gtk/gtkapplication.c
index 24a580af9f3d8828eb29c8761c6615791537e31f..c46d4562d4b00c6dd74fe1bc73cae667af356eb8 100644 (file)
--- a/gtk/gtkapplication.c
+++ b/gtk/gtkapplication.c
@@ -754,7 +754,7 @@ gtk_application_class_init (GtkApplicationClass *class)
 
 /**
  * gtk_application_new:
- * @application_id: the application id
+ * @application_id (allow-none): The application ID.
  * @flags: the application flags
  *
  * Creates a new #GtkApplication instance.
@@ -774,7 +774,12 @@ gtk_application_class_init (GtkApplicationClass *class)
  * you can explicitly call gtk_init() before creating the application
  * instance.
  *
- * The application id must be valid. See g_application_id_is_valid().
+ * If non-%NULL, the application ID must be valid.  See
+ * g_application_id_is_valid().
+ *
+ * If no application ID is given then some features (most notably application 
+ * uniqueness) will be disabled. A null application ID is only allowed with 
+ * GTK+ 3.6 or later.
  *
  * Returns: a new #GtkApplication instance
  *